package com.zhentao.service;

import com.zhentao.dto.*;

/**
 * 高德地图服务接口
 */
public interface AmapService {
    
    /**
     * 地理编码 - 地址转坐标
     * @param request 地理编码请求
     * @return 地理编码响应
     */
    GeocodeResponse geocode(GeocodeRequest request);
    
    /**
     * 逆地理编码 - 坐标转地址
     * @param request 逆地理编码请求
     * @return 逆地理编码响应
     */
    RegeocodeResponse regeocode(RegeocodeRequest request);
    
    /**
     * POI周边搜索
     * @param request POI搜索请求
     * @return POI搜索响应
     */
    AmapPoiSearchResponse searchNearbyPoi(AmapPoiSearchRequest request);
    
    /**
     * 计算两点间距离
     * @param origin 起点坐标
     * @param destination 终点坐标
     * @return 距离（米）
     */
    Integer calculateDistance(String origin, String destination);
    
    /**
     * 获取用户当前位置信息
     * @param latitude 纬度
     * @param longitude 经度
     * @return 位置信息
     */
    RegeocodeResponse getLocationInfo(Double latitude, Double longitude);
}
